home *** CD-ROM | disk | FTP | other *** search
/ The Games Room / The Games Room.iso / amiga / workbench_games / solitaire / solitaire.doc < prev    next >
Encoding:
Text File  |  1994-02-15  |  4.7 KB  |  129 lines
  1.                           Solitaire v1.2
  2.  
  3.                                 /\
  4.                                 \/
  5.  
  6.                      written by Bart Vanhaeren
  7.                      ⌐1993 Quadra Development
  8.  
  9.  
  10. The Aim Of The Game
  11. ===================
  12. 32  stones  are  placed in 33 holes. Only the centre hole is left
  13. open.  You  may  "jump"  with  a stone over the other in an empty
  14. hole,  so  the  middle  stone  is  taken  off the board. The only
  15. allowed  way  to  jump  is  either vertical or horizontal, taking
  16. one stone at maximum.
  17.  
  18. Try  to  take  all stones, keeping one stone left (in the centre)
  19. eventually.  Some  say  this is impossible, but the build-in demo
  20. proves it is possible.
  21.  
  22.  
  23. Story
  24. =====
  25. I  programmed  this little game after playing with the MS-Windows
  26. version  of  the  game.  As  I  am a convinced Amiga user, I felt
  27. that  even  the  most  stupid piece of software couldn't exist on
  28. the  PC  without  a  matching  Amiga  counterpart.  So I made the
  29. thing  in  three days using SAS-C 6.2 on my Amiga 2500/020. It is
  30. supposed  to  fill  the  gap  that  M.Sh.Fayzullin  left  when he
  31. introduced his "WBGames" (which are quite nice, by the way!).
  32.  
  33.  
  34. Game features
  35. =============
  36. Solitaire only runs on Kickstart 2.04 or higher.
  37.  
  38. Solitaire  is  a  so called "Commodity", i.e. the program runs in
  39. the background (it hides) and can be activated with a hotkey.
  40. You  can  set  three Commodity  parameters, all using a tool-type
  41. entry in the icon-info-requester or in the CLI command-line:
  42. CX_POPKEY  is  set  to the hotkey (combination) of Solitaire. The
  43. value  is  a  string describing the key-combination (e.g. 'f1' or
  44. 'shift a' or 'alt esc'). Default is 'ctrl alt s'.
  45. CX_PRIORITY  defines  the  program  priority within the Commodity
  46. system.  The  priority is used to determine wich commodity should
  47. be activated when they have the same hotkey.
  48. CX_POPUP  is either YES or NO. If set to NO, the solitaire window
  49. will not open when launched.
  50.  
  51. other tooltypes are:
  52. SCREEN  lets  you  choose the public screen Solitaire should open
  53. on.  The  value  is  a  string with the public screenname. If the
  54. screen  doesn't  exist, Solitaire will open on the default public
  55. screen (probably WorkBench).
  56. XCOORD   and  YCOORD  define  the  upper  xy-coordinates  of  the
  57. Solitaire  window.  So  you  can place the window at opening time
  58. wherever you want.
  59.  
  60. All other program functions are grouped in standard menus:
  61.  
  62. Project/Hide : "Hides"  the  program.   Reactivate  it  with  the
  63.                hotkey.  The  window  close-gadget  has  the  same
  64.                function.
  65. Project/About: Displays some credits.
  66. Project/Quit : Quits  and  removes the program from the Commodity
  67.                system.
  68. Solitaire/New Game: Abandons current game and starts a new one.
  69. Solitaire/Demo    : Simulates a very good player ! Watch him !
  70.  
  71. Solitaire  uses  a  minimum of system recources. The memory usage
  72. and  code  size  was  limited as much as possible, and as for CPU
  73. usage,  I  think a small game like this just hasn't much need for
  74. processor power... (usage is 0% most of the time).
  75.  
  76. Acknowledgements
  77. ================
  78. Thanks  to  Frank  Maesen  for  his  Commodity  research and ▀eta
  79. testing. Some code in Solitaire was originally his work.
  80.  
  81. Also   thank  you  to  Marat  Fayzullin,  because  his  "WBGames"
  82. inspired me to start programming Solitaire.
  83.  
  84. Finally,  hip  hip houra for Commodore-Amiga because they provide
  85. us the best microcomputer with a great operating system !
  86.  
  87.  
  88. History
  89. =======
  90. * v1.0 (7.5.93)
  91.   Initial version. Smashed it into 12124 bytes (only!).
  92.  
  93. * v1.1 (10.5.93)
  94.   -Fixed esthetical bug when window opened with screenfont higher
  95.    then 8 pixels (made window GimmeZeroZero).
  96.   -Hotkey is now displayed in screentitle.
  97.   -Menus are NewLookMenus under Kick 3.0 or higher.
  98.   -Window  now  refreshes  itself,  saves  memory but is a little
  99.    slower.
  100.   -Removed a bug causing enforcer hits.
  101.   -Added 3 new tooltypes: SCREEN, XCOORD, YCOORD.
  102.    (Now you can play Solitaire everyware !)
  103.   -Demo  is  now  'event'-sensitive. Menuselections, etc. are now
  104.    evaluated.
  105.   -Code size bumped up to 12356 octagonal bits (also know as bytes).
  106.  
  107. * v1.2 (15.2.94)
  108.   -Added CX_POPUP tooltype (Commodore guidelines!)
  109.   -Removed a small bug in the window-refreshing routine.
  110.   -Now uses default screen font instead of topaz.8.
  111.   -Selecting Quit while playing demo WILL quit now.
  112.   -Selecting Hide while playing demo WILL hide now.
  113.   -Selecting New Game while playing demo will stop the demo.
  114.   -Grabbing an element while playing demo will not crash the
  115.    Amiga anymore. It simply cancels the demo.
  116.  
  117. Contact Me
  118. ==========
  119.  
  120. /\
  121. \/ Quadra Development
  122.   Weg naar Zwartberg 248
  123.   B-3660 Opglabbeek (Belgium)
  124.  
  125. Suggestions, donations and bug-reports are welcome !
  126.  
  127.  
  128. Have a nice (pl/d)ay ! Bart Vanhaeren -).
  129.